home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / dmedia / dmconvert.z / dmconvert
Text File  |  1998-10-30  |  54KB  |  991 lines
  1.  
  2.  
  3.  
  4. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      dmconvert - digital media file conversion utility
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt [[[[ooooppppttttiiiioooonnnnssss]]]] iiiinnnnffffiiiilllleeee1111 [[[[............ iiiinnnnffffiiiilllleeeeNNNN]]]] [[[[oooouuuuttttffffiiiilllleeee]]]]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _d_m_c_o_n_v_e_r_t converts between different digital media files.  Input files
  16.      are combined, converted, and written to an output file of a selected
  17.      format.  _d_m_c_o_n_v_e_r_t may also be used to describe input files without
  18.      converting to an output file.
  19.  
  20.      Supported files include the following audio, image, and movie formats.
  21.      The output file format is specified with the ----ffff option, and may be any of
  22.      the formats except those marked describe-only or read-only.
  23.  
  24.               _F_o_r_m_a_t   _D_e_s_c_r_i_p_t_i_o_n
  25.  
  26.      _A_u_d_i_o    aifc     Audio Interchange File Format w/ compression
  27.               aiff     Audio Interchange File Format
  28.               avr      Audio Visual Research
  29.               bicsf    Berkeley/IRCAM/CARL Sound File Format
  30.               iff      Amiga IFF/8SVX
  31.             d midi     Musical Instrument Digital Interface
  32.               mpeg1a   MPEG-1 audio bitstream
  33.               next     NeXT/Sun audio
  34.               rawaudio Raw audio data
  35.               sd2      Sound Designer II
  36.               sf2      Creative Labs SoundFont2 Compatible
  37.               smp      SampleVision
  38.               voc      Creative Labs VOC
  39.               wave     WAVE audio
  40.  
  41.      _I_m_a_g_e    bmp      Microsoft Windows Bit Map
  42.               cur      Microsoft Windows Cursor
  43.             w eps      Encapsulated PostScript
  44.               fit      File Format for Image Tiling
  45.               gif      Graphics Image File
  46.               hdf      Hierarchical Data Format
  47.               ico      Microsoft Windows Icon
  48.               icon     Sun Icon and Cursor
  49.               jfif     JPEG File Interchange Format
  50.               mpnt     Apple Macintosh MacPaint
  51.               pbm      Portable Bit Map
  52.             r pcd      Kodak PhotoCD
  53.               pgm      Portable Grayscale Map
  54.               pic      PIXAR Picture
  55.               pict     Apple Macintosh QuickDraw/PICT
  56.               pix      Alias Pixel
  57.               pnm      Portable Any Map
  58.               ppm      Portable Pixel Map
  59.             w ps       PostScript
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  71.  
  72.  
  73.  
  74.               ras      Sun Raster
  75.             w rawrgb   Raw pixels packed as rgb
  76.               rgb      SGI RGB image
  77.               rgbA     SGI RGB image with generated alpha
  78.               rgba     SGI RGB image with alpha
  79.               rla      Wavefront Raster
  80.               rle      Utah Runlength-encoded
  81.               rpbm     Raw Portable Bit Map
  82.               rpgm     Raw Portable Grayscale Map
  83.               rpnm     Raw Portable Any Map
  84.               rppm     Raw Portable Pixel Map
  85.             r soft     SoftImage PIC
  86.               synu     SDSC Synu
  87.               tga      Truevision Targa
  88.               tiff     Tagged Image File Format
  89.               viff     Khoros Visualization Image File Format
  90.               x        Stardent AVS X
  91.               xbm      X11 Bit Map
  92.               xwd      X Window Dump
  93.  
  94.      _M_o_v_i_e    avi      AVI movie
  95.               mpeg1s   MPEG-1 systems bitstream
  96.               mpeg1v   MPEG-1 video bitstream
  97.               qt       QuickTime
  98.               sgimv    SGI movie
  99.  
  100.      (d = describe-only, r = read-only, w = write-only)
  101.  
  102.      At most one audio track and one video track is converted for each file.
  103.      Input QuickTime files with multiple tracks are rendered as a single
  104.      combined audio track and a single combined video track.
  105.  
  106.      The audio track in the output is obtained by concatenating audio tracks
  107.      from the inputs, and likewise for the video track.  Tracks to be written
  108.      out may be selected and converted with the ----pppp option.
  109.  
  110.      Sequences of image files may be specified in place of regular filename
  111.      arguments by using special template strings.  These template names
  112.      contain a '#' character, and are defined using the ----nnnn option.
  113.  
  114.      If _d_m_c_o_n_v_e_r_t is stopped with SIGINT (<Ctrl C>), a valid output file is
  115.      written with whatever data has been processed.  The signal SIGTERM also
  116.      stops the program, but causes the output to be deleted.
  117.  
  118.  
  119. CCCCOOOONNNNTTTTEEEENNNNTTTTSSSS
  120.      The next six sections discuss the many features that are supported.  At
  121.      the end of each section, several examples are provided to illustrate
  122.      program usage.
  123.  
  124.      _O_p_t_i_o_n_s
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  137.  
  138.  
  139.  
  140.      _F_i_l_e _S_u_b_o_p_t_i_o_n_s
  141.  
  142.      _A_u_d_i_o _S_u_b_o_p_t_i_o_n_s
  143.  
  144.      _V_i_d_e_o _S_u_b_o_p_t_i_o_n_s
  145.  
  146.      _T_e_m_p_l_a_t_e _S_u_b_o_p_t_i_o_n_s
  147.  
  148.      _C_o_n_v_e_r_s_i_o_n_s _w_i_t_h _C_o_s_m_o _M_o_v_i_e_s
  149.  
  150.  
  151. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  152.      ----hhhh
  153.           Display help.  No output file is generated.
  154.  
  155.      ----DDDD
  156.           Describe the contents of the files.  No output file is generated.
  157.  
  158.      ----dddd
  159.           Describe files as they are converted.
  160.  
  161.      ----ssss
  162.           Use short format for describing files.
  163.  
  164.      ----llll
  165.           Use long format for describing files.  Currently, this provides
  166.           additional information only for some audio files.
  167.  
  168.      ----qqqq
  169.           Quiet errors.  Do not print error messages.
  170.  
  171.      ----vvvv
  172.           Verbose progress.  Print percentage completed during conversion.
  173.  
  174.      ----ffff ffffiiiilllleeee____ffffoooorrrrmmmmaaaatttt[[[[,,,,ssssuuuubbbbooooppppttttiiiioooonnnnssss]]]]
  175.           Output file specification.  _F_i_l_e__f_o_r_m_a_t may be any of the digital
  176.           media formats except those that are read-only.  Some file
  177.           characteristics may be set with the _s_u_b_o_p_t_i_o_n_s described in the
  178.           File Suboptions section.
  179.  
  180.      ----pppp ppppaaaatttthhhh[[[[,,,,ssssuuuubbbbooooppppttttiiiioooonnnnssss]]]]
  181.           Enable the specified path to the output file.  _P_a_t_h is a track type
  182.           and may be "audio" or "video".  Data conversion operations on enabled
  183.           paths may be characterized by using the _s_u_b_o_p_t_i_o_n_s described in the
  184.           Audio and Video Suboptions sections.
  185.  
  186.           If this option is not used, all tracks are enabled by default.  If
  187.           this option is used, each track to be written out must be explicitly
  188.           enabled.
  189.  
  190.      ----nnnn tttteeeemmmmppppllllaaaatttteeee____nnnnaaaammmmeeee[[[[,,,,ssssuuuubbbbooooppppttttiiiioooonnnnssss]]]]
  191.           Image sequence templates.  Each filename may be in the form of a
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  203.  
  204.  
  205.  
  206.           template that specifies a sequence of image files.  This option
  207.           defines a _t_e_m_p_l_a_t_e__n_a_m_e that may be used subsequently in place
  208.           of any of the arguments _i_n_f_i_l_e_1, ..., _i_n_f_i_l_e_N, or _o_u_t_f_i_l_e.
  209.  
  210.           _t_e_m_p_l_a_t_e__n_a_m_e is a string with '#' characters designating integer
  211.           indices to be filled in.  The number of '#' characters indicates
  212.           the minimum field length for each index; left padding with zeros
  213.           is performed as needed in order to meet this minimum.  By default,
  214.           indices start at 0 and increment by 1 until either no more files
  215.           exist (for inputs) or no more files need to be written (for outputs).
  216.           A template may be customized using the _s_u_b_o_p_t_i_o_n_s described in the
  217.           Template Suboptions section.
  218.  
  219.           If this option is not used, a filename with '#' characters is
  220.           automatically interpreted as a template if the filename does not
  221.           already exist as a regular file and, for outputs, if the selected
  222.           file format is an image format.
  223.  
  224.      ------------------------------------------------
  225.      **** EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS ****
  226.      ------------------------------------------------
  227.  
  228.      Print help information.
  229.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----hhhh
  230.  
  231.      Describe the input files.
  232.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----DDDD ----llll iiiinnnn....aaaaiiiiffffffff iiiinnnn....rrrrggggbbbb iiiinnnn....mmmmoooovvvviiiieeee iiiinnnn....mmmmppppssss
  233.  
  234.      Describe the digital media files in the current directory.
  235.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----DDDD ----ssss ----qqqq ****
  236.  
  237.      Make an MPEG-1 audio bitstream from an AIFF audio file.
  238.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff mmmmppppeeeegggg1111aaaa ----pppp aaaauuuuddddiiiioooo iiiinnnn....aaaaiiiiffffffff oooouuuutttt....mmmmppppaaaa
  239.  
  240.      Make an audio/video SGI movie from an AIFF-C audio file and a
  241.      video-only SGI movie.
  242.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff ssssggggiiiimmmmvvvv ----pppp aaaauuuuddddiiiioooo ----pppp vvvviiiiddddeeeeoooo iiiinnnn....aaaaiiiiffffcccc iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt....mmmmoooovvvviiiieeee
  243.  
  244.      Make a video-only QuickTime movie from an audio/video SGI movie.
  245.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff qqqqtttt ----pppp vvvviiiiddddeeeeoooo iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt....mmmmoooovvvv
  246.  
  247.      Make a sequence of SGI rgb files from the video track of an SGI movie.
  248.      The output files will be named out00.rgb, out01.rgb, ...
  249.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff rrrrggggbbbb ----pppp vvvviiiiddddeeeeoooo ----nnnn oooouuuutttt########....rrrrggggbbbb iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt########....rrrrggggbbbb
  250.  
  251.      Make an AIFF audio file from a NeXT file and a WAVE file.  Also
  252.      describe the files and print progress information.
  253.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff aaaaiiiiffffffff ----pppp aaaauuuuddddiiiioooo ----dddd ----vvvv iiiinnnn....nnnneeeexxxxtttt iiiinnnn....wwwwaaaavvvveeee oooouuuutttt....aaaaiiiiffffffff
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  269.  
  270.  
  271.  
  272. FFFFIIIILLLLEEEE SSSSUUUUBBBBOOOOPPPPTTTTIIIIOOOONNNNSSSS
  273.      The file suboptions are specified as a comma-separated list of
  274.      _s_u_b_o_p_t=_v_a_l_u_e pairs.  These provide additional information about the
  275.      output file.  The available suboptions are
  276.  
  277.      bbbbrrrraaaatttteeee
  278.           overall bitrate of the output file.  Supported for files
  279.           that use MPEG-1, Cinepak, or Cosmo JPEG compression.  For
  280.           files that contain only one track, this sets the bitrate
  281.           of that track.
  282.  
  283.      lllloooooooopppp
  284.           default looping mode of the output movie during playback
  285.           ("once", "loop", or "swing").  Supported for SGI movies.
  286.  
  287.      iiiinnnntttteeeerrrrlllleeeeaaaavvvveeee
  288.           granularity in seconds of audio and video interleaving.
  289.           For example, to write audio and video in alternating chunks
  290.           of duration 0.5 seconds each, use an interleave value of 0.5.
  291.           Supported for SGI/QuickTime movies.
  292.  
  293.      ppppaaaarrrraaaammmmffffiiiilllleeee
  294.           parameter file for customizing outputs.  Supported for MPEG-1
  295.           audio, video, and systems bitstreams.  For an example, see
  296.           /usr/lib/dmconvert/mpeg1.par.
  297.  
  298.      ------------------------------------------------
  299.      **** EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS ****
  300.      ------------------------------------------------
  301.  
  302.      Make an MPEG-1 video bitstream at 1.5 Mbps.
  303.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff mmmmppppeeeegggg1111vvvv,,,,bbbbrrrraaaatttteeee====1111555500000000000000000000 iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt....mmmmppppvvvv
  304.  
  305.      Make an SGI movie with a specific looping mode and interleave.
  306.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff ssssggggiiiimmmmvvvv,,,,lllloooooooopppp====sssswwwwiiiinnnngggg,,,,iiiinnnntttteeeerrrrlllleeeeaaaavvvveeee====0000....1111 iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt....mmmmoooovvvviiiieeee
  307.  
  308.      Make an MPEG-1 systems bitstream using a parameter customization file.
  309.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff mmmmppppeeeegggg1111ssss,,,,ppppaaaarrrraaaammmmffffiiiilllleeee====mmmmppppeeeegggg1111....ppppaaaarrrr iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt....mmmmppppssss
  310.  
  311.  
  312. AAAAUUUUDDDDIIIIOOOO SSSSUUUUBBBBOOOOPPPPTTTTIIIIOOOONNNNSSSS
  313.      The audio suboptions are specified as a comma-separated list of
  314.      _s_u_b_o_p_t=_v_a_l_u_e pairs.  These are used to configure the processing of audio
  315.      data from input to output.  Processing consists of a pipeline of
  316.      individual conversion operations.  Suboptions may be specified in any
  317.      order, but the actual order of operations is given by
  318.  
  319.        rate->channels->pcmmap/format/width->compression
  320.  
  321.      The available suboptions are
  322.  
  323.      rrrraaaatttteeee
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  335.  
  336.  
  337.  
  338.           frame rate of the output audio track.  If the input track
  339.           has a different rate, automatic rate conversion is performed.
  340.           For conversions between the standard rates, 8000, 11025, 16000,
  341.           22050, 32000, 44100, and 48000 Hz, high quality filters are used.
  342.           For conversions with other rates, simple algorithms of lower
  343.           quality are used.
  344.  
  345.           In the special case of converting from 8012.8210513 Hz audio
  346.           (common in NeXT files) to a rate other than 8000 Hz, the input
  347.           samples are automatically interpreted as 8000 Hz so that the
  348.           high quality filters are used.  To avoid this small pitch shift,
  349.           first convert to an 8000 Hz sound track (the simple algorithm
  350.           should be acceptable), then to the desired rate.
  351.  
  352.      ssssttttooooppppaaaatttttttteeeennnn
  353.           stopband attenuation of the rate conversion filter (78.0, 96.0,
  354.           or 120.0 dB); applies only to conversions between the standard
  355.           rates.  Higher values produce better quality but require more
  356.           computation.
  357.  
  358.      ttttrrrraaaannnnsssswwww
  359.           transition bandwidth of the rate conversion filter (1.0, 10.0,
  360.           or 20.0 percent); applies only to conversions between the stand-
  361.           ard rates.  Lower values produce better quality but require more
  362.           computation.
  363.  
  364.      cccchhhhaaaannnn
  365.           number of channels in the output audio track (1, 2, or 4).
  366.  
  367.      ppppccccmmmmmmmmaaaapppp
  368.           PCM mapping of the output audio track.  Value may take the form
  369.           "slope/intercept/minclip/maxclip" or just "slope", which is
  370.           equivalent to "slope/0/0/0".  This maps output sample
  371.           values to the range [intercept-slope,intercept+slope].  If
  372.           minclip<maxclip, clipping to these limits is performed as well.
  373.  
  374.      ffffoooorrrrmmmmaaaatttt
  375.           sample format in the output audio track ("2scomp", "unsigned",
  376.           "float", or "double").
  377.  
  378.      wwwwiiiiddddtttthhhh
  379.           sample width in the output audio track (1-32 bits).  Not
  380.           relevant for float or double sample formats.
  381.  
  382.      ccccoooommmmpppp
  383.           compression scheme to apply to the output audio track ("none",
  384.           "g711a", "g711u", "g722", "g726", "g728", "gsm", "dvi", "mpeg1",
  385.           or "multirate").  Supported for AIFF-C, NeXT/Sun, VOC, and WAVE
  386.           files.  Not every compression scheme is supported by each of
  387.           these.
  388.  
  389.      bbbbrrrraaaatttteeee
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  401.  
  402.  
  403.  
  404.           bitrate to use for the output audio track.  Supported for
  405.           MPEG-1 compression.  If the output file has only one track
  406.           and the file bitrate suboption is also specified, the file
  407.           bitrate takes precedence.
  408.  
  409.      llllaaaayyyyeeeerrrr
  410.           encoding layer to use for MPEG-1 compression (1, 2).
  411.  
  412.      cccchhhhaaaannnnmmmmooooddddeeee
  413.           channel mode to use for MPEG-1 or Multirate compression
  414.           ("stereo", "joint", or "dual").  Related channels should be
  415.           encoded as "stereo" or "joint".  The latter exploits inter-
  416.           channel redundancy for better compression.  Independent
  417.           channels should be encoded as "dual".
  418.  
  419.      bbbbrrrraaaatttteeeeppppoooollll
  420.           bitrate policy to use for MPEG-1 or Multirate compression
  421.           ("fixed", "constqual", or "lossless").  MPEG-1 encoding may
  422.           operate at either a fixed bitrate or constant quality.
  423.           Multirate encoding may operate at either constant quality
  424.           or in lossless mode.
  425.  
  426.      nnnnmmmmrrrr
  427.           noise-to-mask-ratio to use for constant quality MPEG-1
  428.           compression (-13.0 to 13.0 dB).  Zero yields a theoretically
  429.           imperceptible noise level.  Positive values provide more
  430.           compression but more noise, and negative values, vice versa.
  431.  
  432.      bbbbyyyytttteeeeoooorrrrdddd
  433.           byte ordering of the output audio track ("big" or "little"
  434.           endian).  Supported for uncompressed raw audio output.
  435.  
  436.      The following suboptions describe the input.
  437.  
  438.      iiiinnnnrrrraaaawwww
  439.           indicates whether the input files consist of raw audio data
  440.           ("true" or "false").  If true, no other input file formats
  441.           are recognized.
  442.  
  443.      iiiinnnnddddaaaattttaaaaooooffffffff,,,,iiiinnnnffffrrrraaaammmmeeeeccccnnnntttt
  444.           the data offset in bytes from the beginning of file, and the
  445.           total number of audio frames.  Relevant only for raw audio
  446.           inputs.
  447.  
  448.      iiiinnnnrrrraaaatttteeee,,,,iiiinnnncccchhhhaaaannnn,,,,iiiinnnnffffoooorrrrmmmmaaaatttt,,,,iiiinnnnwwwwiiiiddddtttthhhh,,,,iiiinnnnccccoooommmmpppp,,,,iiiinnnnbbbbyyyytttteeeeoooorrrrdddd
  449.           frame rate, channels, sample format, sample width, compression,
  450.           and byte ordering of the input.  Relevant only for raw audio
  451.           inputs.
  452.  
  453.      iiiinnnnppppccccmmmmmmmmaaaapppp
  454.           the PCM mapping that describes the input sample range.  Value
  455.           is given in the same form as the output PCM mapping.  Input
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  467.  
  468.  
  469.  
  470.           clipping will be performed before main conversions such as
  471.           frame rate, channels, etc.
  472.  
  473.  
  474.  
  475.      ------------------------------------------------
  476.      **** EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS ****
  477.      ------------------------------------------------
  478.  
  479.      Make a 32 KHz AIFF file from an 8KHz input using the highest quality
  480.      rate conversion.
  481.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff aaaaiiiiffffffff ----pppp aaaauuuuddddiiiioooo,,,,rrrraaaatttteeee====33332222000000000000,,,,ssssttttooooppppaaaatttttttteeeennnn====111122220000....0000,,,,ttttrrrraaaannnnsssswwww====1111....0000
  482.      iiiinnnn....aaaaiiiiffffffff oooouuuutttt....aaaaiiiiffffffff
  483.  
  484.      Make a two-channel AIFF file from a mono input.
  485.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff aaaaiiiiffffffff ----pppp aaaauuuuddddiiiioooo,,,,cccchhhhaaaannnn====2222 iiiinnnn....aaaaiiiiffffffff oooouuuutttt....aaaaiiiiffffffff
  486.  
  487.      Make a NeXT file that has float samples.  Scale the samples to the range
  488.      [-5.0,5.0] and also clip values less than -4.5 and greater than 4.5.
  489.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff nnnneeeexxxxtttt ----pppp aaaauuuuddddiiiioooo,,,,ffffoooorrrrmmmmaaaatttt====ffffllllooooaaaatttt,,,,ppppccccmmmmmmmmaaaapppp====5555....0000////0000....0000////----4444....5555////4444....5555
  490.      iiiinnnn....aaaaiiiiffffffff oooouuuutttt....nnnneeeexxxxtttt
  491.  
  492.      Make an AIFF file that has 8-bit twos-complement samples.
  493.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff aaaaiiiiffffffff ----pppp aaaauuuuddddiiiioooo,,,,ffffoooorrrrmmmmaaaatttt====2222ssssccccoooommmmpppp,,,,wwwwiiiiddddtttthhhh====8888 iiiinnnn....aaaaiiiiffffffff oooouuuutttt....aaaaiiiiffffffff
  494.  
  495.      Make an AIFF-C file that uses Layer II MPEG-1 compression at 192 Kbps,
  496.      with the channels encoded under "joint" mode.
  497.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff aaaaiiiiffffcccc ----pppp aaaauuuuddddiiiioooo,,,,ccccoooommmmpppp====mmmmppppeeeegggg1111,,,,bbbbrrrraaaatttteeee====111199992222000000000000,,,,llllaaaayyyyeeeerrrr====2222,,,,cccchhhhaaaannnnmmmmooooddddeeee====jjjjooooiiiinnnntttt
  498.      iiiinnnn....aaaaiiiiffffffff oooouuuutttt....aaaaiiiiffffcccc
  499.  
  500.      Make an AIFF-C MPEG-1 file using constant quality encoding and a low
  501.      noise-to-mask ratio.
  502.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff aaaaiiiiffffcccc ----pppp aaaauuuuddddiiiioooo,,,,ccccoooommmmpppp====mmmmppppeeeegggg1111,,,,bbbbrrrraaaatttteeeeppppoooollll====ccccoooonnnnssssttttqqqquuuuaaaallll,,,,nnnnmmmmrrrr====----11110000....0000
  503.      iiiinnnn....aaaaiiiiffffffff oooouuuutttt....aaaaiiiiffffcccc
  504.  
  505.      Make a file of raw audio samples that are written as little-endian.
  506.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff rrrraaaawwwwaaaauuuuddddiiiioooo ----pppp aaaauuuuddddiiiioooo,,,,ffffoooorrrrmmmmaaaatttt====2222ssssccccoooommmmpppp,,,,wwwwiiiiddddtttthhhh====11116666,,,,bbbbyyyytttteeeeoooorrrrdddd====lllliiiittttttttlllleeee
  507.      iiiinnnn....aaaaiiiiffffffff oooouuuutttt....rrrraaaawwww
  508.  
  509.      Make a WAVE audio file from raw input samples.  The samples are extracted
  510.      from the middle of the input file, and their characteristics are fully
  511.      described.
  512.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff wwwwaaaavvvveeee ----pppp aaaauuuuddddiiiioooo,,,,iiiinnnnrrrraaaawwww====ttttrrrruuuueeee,,,,iiiinnnnddddaaaattttaaaaooooffffffff====111100000000,,,,iiiinnnnffffrrrraaaammmmeeeeccccnnnntttt====4444000000000000,,,,
  513.      iiiinnnnrrrraaaatttteeee====44444444111100000000,,,,iiiinnnncccchhhhaaaannnn====2222,,,,iiiinnnnffffoooorrrrmmmmaaaatttt====2222ssssccccoooommmmpppp,,,,iiiinnnnwwwwiiiiddddtttthhhh====11116666,,,,iiiinnnnccccoooommmmpppp====nnnnoooonnnneeee,,,,
  514.      iiiinnnnbbbbyyyytttteeeeoooorrrrdddd====bbbbiiiigggg,,,,iiiinnnnppppccccmmmmmmmmaaaapppp====33330000000000000000 iiiinnnn....rrrraaaawwww oooouuuutttt....wwwwaaaavvvveeee
  515.  
  516.  
  517. VVVVIIIIDDDDEEEEOOOO SSSSUUUUBBBBOOOOPPPPTTTTIIIIOOOONNNNSSSS
  518.      The video suboptions are specified as a comma-separated list of
  519.      _s_u_b_o_p_t=_v_a_l_u_e pairs.  These are used to configure the processing of video
  520.      data from input to output.  Processing consists of a pipeline of
  521.      individual conversion operations.  Suboptions may be specified in any
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  533.  
  534.  
  535.  
  536.      order, but the actual order of operations is given by
  537.  
  538.        rate->interlace->layout/orientation->crop->filter->size->compression
  539.  
  540.      The available suboptions are
  541.  
  542.      rrrraaaatttteeee
  543.           frame rate of the output video track.  If the input track has a
  544.           different rate, automatic rate conversion is performed.
  545.  
  546.      rrrraaaatttteeeeccccvvvvtttt
  547.           type of rate conversion to use ("rptdrp" or "inv32").  Repeat-drop
  548.           is the simpler scheme.  Inverse 3:2 pulldown may be used to convert
  549.           30 to 24 fps, or 29.97 to 23.976 fps.
  550.  
  551.      iiiillll
  552.           interlacing of the output video track.  May be "none" (non-
  553.           interlaced), "even" (even lines temporally first), or "odd"
  554.           (odd lines temporally first).
  555.  
  556.      iiiillllccccvvvvtttt
  557.           type of interlace conversion to use.  Supported types are
  558.  
  559.           "pn_interfield" (odd/even parity to non-interlaced)
  560.                A non-linear filter is applied between the fields for
  561.                high quality de-interlacing.
  562.  
  563.           "pn_combine" (odd/even parity to non-interlaced)
  564.                The fields are temporally combined without modification.
  565.  
  566.           "np_separate" (non-interlaced to odd/even parity)
  567.                The fields are temporally separated without modification.
  568.  
  569.           "pp_swap" (odd to even parity, or vice versa)
  570.                The fields are temporally swapped without modification.
  571.  
  572.      ffffllll
  573.           frame layout of the output video track.  May be "full" (full
  574.           frame) or "split" (split fields).  The frame layout indicates
  575.           how video lines are stored, and is not the same as interlacing,
  576.           which indicates how the lines are temporally sampled.  For
  577.           example, interlaced video may be stored as full frames or split
  578.           fields, whereas non-interlaced video is usually stored as full
  579.           frames only.
  580.  
  581.           This suboption is supported for image files.  For SGI movies,
  582.           the frame layout is currently restricted to split fields for
  583.           interlaced data and full frames for non-interlaced data, so the
  584.           interlacing suboption also serves to specify the output frame
  585.           layout.
  586.  
  587.      oooorrrr
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  599.  
  600.  
  601.  
  602.           orientation of images in output video track.  May be "b2t"
  603.           (bottom-to-top) or "t2b" (top-to-bottom).  Supported for making
  604.           SGI movies.
  605.  
  606.      ccccrrrrooooppppllll,,,,ccccrrrroooopppprrrr,,,,ccccrrrroooopppptttt,,,,ccccrrrrooooppppbbbb
  607.           number of pixels to crop from left, right, top, and bottom
  608.           borders of input images.  For interlaced material, top and
  609.           bottom cropping should be even numbers.
  610.  
  611.      ffffiiiilllltttt
  612.           filter to apply during conversion.  The following values
  613.           are recognized.
  614.  
  615.           "vblur"
  616.                blur images with vertical 1-2-1 convolution, where the
  617.                center tap corresponds to the field opposite to that of
  618.                the outer taps.  Useful for reducing flicker if output
  619.                images are played back through video.  Supported for
  620.                making image files and SGI/QuickTime movies.
  621.  
  622.           "soft", "softmax"
  623.                soften images with normal or maximum settings.  Useful
  624.                as a preprocessing step before compression.  Supported
  625.                for MPEG-1 movies.
  626.  
  627.      ssssxxxx,,,,ssssyyyy,,,,ssssiiiizzzzeeee
  628.           size of output image in pixels.  Supported for making image
  629.           files and movies.  ssssxxxx and ssssyyyy are used to specify individual
  630.           dimensions.  ssssiiiizzzzeeee is used to specify both dimensions, where
  631.           the value is expressed as WxH (e.g. 640x480) or one of the
  632.           strings "orig" or "sif".  For interlaced material, the height
  633.           should be an even number.
  634.  
  635.      llllbbbbooooxxxx
  636.           letterboxing flag ("true" or "false").  If false, the input
  637.           images are scaled as needed to fill the output size, which
  638.           may require different scale factors in each dimension.  If
  639.           true, a common scale factor is used and any remaining space
  640.           is filled with black.  Supported for making image files and
  641.           SGI/QuickTime movies.
  642.  
  643.      ccccoooommmmpppp
  644.           compression scheme to apply to the output video track ("none",
  645.           "jpeg", "mvc1", "mvc2", "qt_anim", "qt_video", "qt_cvid",
  646.           "qt_mjpega", "rle", or "rle24").  The Compact Video scheme,
  647.           "qt_cvid", is also known as Cinepak.  The "qt_mjpega" represents
  648.           Quicktime's Motion JPEG Format A.  Supported for SGI/QuickTime
  649.           movies. SGI movies cannot use scheme's with the "qt_" prefix.
  650.  
  651.      eeeennnnggggiiiinnnneeee
  652.           engine used during the conversion ("cosmo" or "sw").  Supported for
  653.           JPEG compression or decompression.
  654.  
  655.  
  656.  
  657.                                                                        PPPPaaaaggggeeee 11110000
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  665.  
  666.  
  667.  
  668.      bbbbrrrraaaatttteeee
  669.           bitrate to use for the output video track.  Supported for MPEG-1,
  670.           Cinepak, and Cosmo JPEG compression.  If the output file has only
  671.           one track and the file bitrate suboption is also specified, the
  672.           file bitrate takes precedence.
  673.  
  674.      ssssqqqquuuuaaaallll
  675.           spatial quality factor used in compression (0.0 - 1.0).  Supported
  676.           for SGI/QuickTime movies.  This is useful for setting the spatial
  677.           quality of video tracks compressed with JPEG or a QuickTime scheme.
  678.  
  679.      ttttqqqquuuuaaaallll
  680.           temporal quality factor used in compression (0.0 - 1.0).  Supported
  681.           for QuickTime movies.  This is useful for setting the temporal
  682.           quality of tracks compressed with a QuickTime scheme.
  683.  
  684.      kkkkddddiiiisssstttt
  685.           distance between key frames.  Supported for QuickTime and MPEG-1
  686.           video compression schemes.  For MPEG-1 this is equivalent to the
  687.           N parameter, which gives the distance between I frames.
  688.  
  689.      rrrrddddiiiisssstttt
  690.           distance between reference frames.  Supported for MPEG-1 video
  691.           compression.  This is equivalent to the M parameter, which gives
  692.           the distance between I or P frames.  For example, the pattern
  693.           IBBPBBI (M=3,N=6), would be specified by rdist=3 and kdist=6.
  694.  
  695.      The following suboptions describe the input, and are useful for adding
  696.      information about image files.
  697.  
  698.      iiiinnnnrrrraaaatttteeee,,,,iiiinnnniiiillll,,,,iiiinnnnffffllll
  699.           frame rate, interlacing, and frame layout of input images.
  700.  
  701.      iiiinnnnppppiiiixxxxaaaasssspppp
  702.           pixel aspect ratio of input images.  This is a float defined as
  703.           the vertical extent of a pixel divided by its horizontal extent.
  704.           It may also be specified as one of the following strings - "sq"
  705.           (square pixels), "c525" (CCIR601 525), or "c625" (CCIR601 625).
  706.           Used in making SGI movies or MPEG-1 movies.
  707.  
  708.      ------------------------------------------------
  709.      **** EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS ****
  710.      ------------------------------------------------
  711.  
  712.      Make a 23.976 fps MPEG-1 video bitstream from a 29.97 fps SGI movie
  713.      using inverse 3:2 pulldown.
  714.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff mmmmppppeeeegggg1111vvvv ----pppp vvvviiiiddddeeeeoooo,,,,rrrraaaatttteeee====22223333....999977776666,,,,rrrraaaatttteeeeccccvvvvtttt====iiiinnnnvvvv33332222 iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt....mmmmppppvvvv
  715.  
  716.      Make a non-interlaced SGI movie from an even-interlaced SGI movie
  717.      using interfield filtering.
  718.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff ssssggggiiiimmmmvvvv ----pppp vvvviiiiddddeeeeoooo,,,,iiiillll====nnnnoooonnnneeee,,,,iiiillllccccvvvvtttt====ppppnnnn____iiiinnnntttteeeerrrrffffiiiieeeelllldddd iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt....mmmmoooovvvviiiieeee
  719.  
  720.  
  721.  
  722.  
  723.                                                                        PPPPaaaaggggeeee 11111111
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  731.  
  732.  
  733.  
  734.      Make a sequence of split field image files, out0.rgb, out1.rgb, ...,
  735.      from an odd-interlaced SGI movie.
  736.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff rrrrggggbbbb ----pppp vvvviiiiddddeeeeoooo,,,,ffffllll====sssspppplllliiiitttt ----nnnn oooouuuutttt####....rrrrggggbbbb iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt####....rrrrggggbbbb
  737.  
  738.      Make a top-to-bottom SGI movie.
  739.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff ssssggggiiiimmmmvvvv ----pppp vvvviiiiddddeeeeoooo,,,,oooorrrr====tttt2222bbbb iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt....mmmmoooovvvviiiieeee
  740.  
  741.      Make an SGI movie by cropping, blurring, and resizing the input video.
  742.      Use letterboxing during the resize.
  743.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff ssssggggiiiimmmmvvvv ----pppp vvvviiiiddddeeeeoooo,,,,ccccrrrrooooppppllll====11110000,,,,ccccrrrroooopppprrrr====11110000,,,,ffffiiiilllltttt====vvvvbbbblllluuuurrrr,,,,ssssiiiizzzzeeee====333322220000xxxx222244440000,,,,
  744.      llllbbbbooooxxxx====ttttrrrruuuueeee iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt....mmmmoooovvvviiiieeee
  745.  
  746.      Make an SGI movie with JPEG video at 10.0 Mbps, and use Cosmo to assist
  747.      in the compression.
  748.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff ssssggggiiiimmmmvvvv ----pppp vvvviiiiddddeeeeoooo,,,,ccccoooommmmpppp====jjjjppppeeeegggg,,,,eeeennnnggggiiiinnnneeee====ccccoooossssmmmmoooo,,,,bbbbrrrraaaatttteeee====11110000000000000000000000000000
  749.      iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt....mmmmoooovvvviiiieeee
  750.  
  751.      Make a QuickTime Cinepak movie at specific spatial and temporal qualities.
  752.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff qqqqtttt ----pppp vvvviiiiddddeeeeoooo,,,,ccccoooommmmpppp====qqqqtttt____ccccvvvviiiidddd,,,,ssssqqqquuuuaaaallll====0000....9999,,,,ttttqqqquuuuaaaallll====0000....5555 iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt....mmmmoooovvvv
  753.  
  754.      Make a QuickTime Motion JPEG Format A movie which has odd interlaced
  755.      fields.  This is a good format for cross-platform field based movies.
  756.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff qqqqtttt ----pppp aaaauuuuddddiiiioooo ----pppp vvvviiiiddddeeeeoooo,,,,ccccoooommmmpppp====qqqqtttt____mmmmjjjjppppeeeeggggaaaa,,,,iiiillll====oooodddddddd mmmmoooovvvviiiieeee oooouuuutttt....mmmmoooovvvv
  757.  
  758.      Make an MPEG-1 systems bitstream with a video frame pattern IBBPBBI.
  759.      The audio track is also written out.
  760.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff mmmmppppeeeegggg1111ssss ----pppp aaaauuuuddddiiiioooo ----pppp vvvviiiiddddeeeeoooo,,,,kkkkddddiiiisssstttt====6666,,,,rrrrddddiiiisssstttt====3333 iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt....mmmmppppssss
  761.  
  762.      Make an MPEG-1 video bitstream from the input image files in0.rgb,
  763.      in1.rgb, ..., and provide information about the input data.
  764.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff mmmmppppeeeegggg1111vvvv ----pppp vvvviiiiddddeeeeoooo,,,,iiiinnnnrrrraaaatttteeee====11115555....0000,,,,iiiinnnniiiillll====eeeevvvveeeennnn,,,,iiiinnnnffffllll====sssspppplllliiiitttt,,,,
  765.      iiiinnnnppppiiiixxxxaaaasssspppp====cccc555522225555 ----nnnn iiiinnnn####....rrrrggggbbbb iiiinnnn####....rrrrggggbbbb oooouuuutttt....mmmmppppvvvv
  766.  
  767.  
  768. TTTTEEEEMMMMPPPPLLLLAAAATTTTEEEE SSSSUUUUBBBBOOOOPPPPTTTTIIIIOOOONNNNSSSS
  769.      The template suboptions are specified as a comma-separated list of
  770.      _s_u_b_o_p_t=_v_a_l_u_e pairs.  These customize how the template name is expanded
  771.      when it is used in place of a regular filename.
  772.  
  773.      The available suboptions are
  774.  
  775.      ssssttttaaaarrrrtttt
  776.           starting index for the sequence of image files.
  777.  
  778.      eeeennnndddd
  779.           ending index for the sequence of image files.
  780.  
  781.      sssstttteeeepppp
  782.           increment to apply to the construction of indices.
  783.  
  784.      ------------------------------------------------
  785.      **** EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS ****
  786.  
  787.  
  788.  
  789.                                                                        PPPPaaaaggggeeee 11112222
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  797.  
  798.  
  799.  
  800.      ------------------------------------------------
  801.  
  802.      Make an SGI movie from the images in.rgb.9, in.rgb.10, and in.rgb.11.
  803.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff ssssggggiiiimmmmvvvv ----nnnn iiiinnnn....rrrrggggbbbb....####,,,,ssssttttaaaarrrrtttt====9999,,,,eeeennnndddd====11111111,,,,sssstttteeeepppp====1111 ----pppp vvvviiiiddddeeeeoooo
  804.      iiiinnnn....rrrrggggbbbb....#### oooouuuutttt....mmmmoooovvvviiiieeee
  805.  
  806.      Make a sequence of ten SGI images from an input movie, and name them
  807.      out01.rgb, out03.rgb, out05.rgb, ..., out19.rgb.
  808.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----ffff rrrrggggbbbb ----nnnn oooouuuutttt########....rrrrggggbbbb,,,,ssssttttaaaarrrrtttt====1111,,,,eeeennnndddd====11119999,,,,sssstttteeeepppp====2222 ----pppp vvvviiiiddddeeeeoooo
  809.      iiiinnnn....mmmmoooovvvviiiieeee oooouuuutttt########....rrrrggggbbbb
  810.  
  811.  
  812. CCCCOOOONNNNVVVVEEEERRRRSSSSIIIIOOOONNNNSSSS WWWWIIIITTTTHHHH CCCCOOOOSSSSMMMMOOOO MMMMOOOOVVVVIIIIEEEESSSS
  813.      _d_m_c_o_n_v_e_r_t may be used to convert from movies recorded with the Cosmo
  814.      Compress option board (ccccllll____ccccoooossssmmmmoooo((((3333ddddmmmm))))), or to produce movies that are
  815.      playable by Cosmo.
  816.  
  817.      Cosmo movies are just SGI movies with particular video characteristics.
  818.      No special treatment is necessary to use these movies as input files, but
  819.      certain settings are required for creating movies playable by Cosmo.  The
  820.      output video track should be constructed with comp=jpeg and or=t2b.
  821.      Further, the dimensions, interlacing, and frame rate should match one of
  822.      the following modes.
  823.  
  824.                         width     height       interlacing   frame rate
  825.                         -----     ------       -----------   ----------
  826.          NTSC           640       480 or 496   odd           29.97
  827.          CCIR601-525    720       480 or 496   odd           29.97
  828.          PAL            768       576          even          25
  829.          CCIR601-625    720       576          even          25
  830.  
  831.      Half-widths and half-heights are also accepted in each mode.
  832.  
  833.      ------------------------------------------------
  834.      **** EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS ****
  835.      ------------------------------------------------
  836.  
  837.      Make an MPEG-1 movie from a Cosmo movie.
  838.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----vvvvffff mmmmppppeeeegggg1111ssss ----pppp aaaauuuuddddiiiioooo ----pppp vvvviiiiddddeeeeoooo,,,,ssssxxxx====333322220000,,,,ssssyyyy====222244440000 ccccoooossssmmmmoooo....mmmmoooovvvviiiieeee oooouuuutttt....mmmmppppssss
  839.  
  840.      Make a QuickTime Cinepak movie from a Cosmo movie.
  841.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----vvvvffff qqqqtttt ----pppp aaaauuuuddddiiiioooo ----pppp vvvviiiiddddeeeeoooo,,,,ccccoooommmmpppp====qqqqtttt____ccccvvvviiiidddd,,,,ssssxxxx====333322220000,,,,ssssyyyy====222244440000,,,,rrrraaaatttteeee====11115555....0000
  842.      ccccoooossssmmmmoooo....mmmmoooovvvviiiieeee oooouuuutttt....mmmmoooovvvv
  843.  
  844.      Make a Cosmo movie from another SGI movie.
  845.      ddddmmmmccccoooonnnnvvvveeeerrrrtttt ----vvvvffff ssssggggiiiimmmmvvvv ----pppp aaaauuuuddddiiiioooo ----pppp vvvviiiiddddeeeeoooo,,,,ccccoooommmmpppp====jjjjppppeeeegggg,,,,oooorrrr====tttt2222bbbb,,,,ssssxxxx====666644440000,,,,ssssyyyy====444488880000,,,,
  846.      iiiillll====oooodddddddd,,,,rrrraaaatttteeee====22229999....99997777 iiiinnnn....mmmmoooovvvviiiieeee ccccoooossssmmmmoooo....mmmmoooovvvviiiieeee
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                                                        PPPPaaaaggggeeee 11113333
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  863.  
  864.  
  865.  
  866. NOTES
  867.      In order for some image files to be recognized, the filename should have
  868.      an extension that matches the file format.  For example, if a Targa file
  869.      "foo" is not recognized, then rename it as "foo.tga".
  870.  
  871.      MacPaint image files are always written as 576x720.
  872.  
  873.      Alpha channel is supported only for SGI images and SoftImage PIC files.
  874.      The "rgbA" output file format computes alpha based on pixel luminance.
  875.  
  876.      Some command-line syntax changes have been made since previous releases.
  877.  
  878.          o the "sgirgb" file format is still supported, but the new
  879.              equivalent is "rgba".
  880.          o the "-p all" option should no longer be used.  This
  881.              functionality is available from the "-f file_format",
  882.              "-p audio", and "-p video" options.
  883.          o the MPEG-1 "file" suboption is now called "paramfile".
  884.  
  885.  
  886. MMMMPPPPEEEEGGGG CCCCAAAAVVVVEEEEAAAATTTTSSSS
  887.      When converting to MPEG-1 systems streams, conversion of large amounts of
  888.      data (typically over 1 GB) stops with the following message:
  889.  
  890.      dmconvert: SGI Compression Library error.  mux: buffer underflow; use
  891.      higher systems bitrate
  892.  
  893.      Increasing the systems bitrate may or may not cause the problem to go
  894.      away. If possible, breaking up the data into chunks and encoding them
  895.      separately should work.
  896.  
  897.  
  898.  
  899. AAAAUUUUTTTTHHHHOOOORRRR
  900.      Silicon Graphics Computer Systems.  Portions developed at the San Diego
  901.      Supercomputer Center.
  902.  
  903.      _d_m_c_o_n_v_e_r_t uses the SGI Audio File, Compression, ImageVision, and Movie
  904.      Libraries to access digital media data.
  905.  
  906.      Many of the image file formats are supported through the San Diego
  907.      Supercomputer Center's image library (libim, libsdsc).  This library is
  908.      available from anonymous ftp at sdsc.edu in the
  909.      /pub/sdsc/graphics/imtools/ directory.  For more information, contact
  910.      info@sdsc.edu.
  911.  
  912.  
  913. FFFFIIIILLLLEEEESSSS
  914.      /usr/lib/dmconvert/mpeg1.par -- sample mpeg1 parameter file
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.                                                                        PPPPaaaaggggeeee 11114444
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))                                                      ddddmmmmccccoooonnnnvvvveeeerrrrtttt((((1111))))
  929.  
  930.  
  931.  
  932. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  933.      dminfo(1), dmplay(1), dmrecord(1),
  934.      soundplayer(1), soundeditor(1),
  935.      imgcopy(1), imginfo(1), imgview(1), imgworks(1),
  936.      mediaconvert(1), movieplayer(1), capture(1), moviemaker(1),
  937.      AFintro(3dm), CLintro(3dm), cl_cosmo(3dm), IL(3il), mvIntro(3dm), mpeg(4)
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                                                                        PPPPaaaaggggeeee 11115555
  988.  
  989.  
  990.  
  991.